home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / hwgraph.vertex.z / hwgraph.vertex
Encoding:
Text File  |  2002-10-03  |  5.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. hhhhwwwwggggrrrraaaapppphhhh....vvvveeeerrrrtttteeeexxxx((((DDDD3333XXXX))))                                        hhhhwwwwggggrrrraaaapppphhhh....vvvveeeerrrrtttteeeexxxx((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _hhhh_wwww_gggg_rrrr_aaaa_pppp_hhhh_...._vvvv_eeee_rrrr_tttt_eeee_xxxx_:::: hwgraph_vertex_create, hwgraph_vertex_destroy,
  10.      hwgraph_vertex_clone, hwgraph_vertex_ref, hwgraph_vertex_unref - manage
  11.      vertexes of hardware graph
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////hhhhwwwwggggrrrraaaapppphhhh....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ddddddddiiii....hhhh>>>>
  17.  
  18.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  19.      hhhhwwwwggggrrrraaaapppphhhh____vvvveeeerrrrtttteeeexxxx____ccccrrrreeeeaaaatttteeee((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt ****_v_h_d_l_p))));;;;
  20.  
  21.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  22.      hhhhwwwwggggrrrraaaapppphhhh____vvvveeeerrrrtttteeeexxxx____ddddeeeessssttttrrrrooooyyyy((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l))));;;;
  23.  
  24.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  25.      hhhhwwwwggggrrrraaaapppphhhh____vvvveeeerrrrtttteeeexxxx____cccclllloooonnnneeee((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l, vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt ****_v_h_d_l_p))));;;;
  26.  
  27.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  28.      hhhhwwwwggggrrrraaaapppphhhh____vvvveeeerrrrtttteeeexxxx____rrrreeeeffff((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l))));;;;
  29.  
  30.      ggggrrrraaaapppphhhh____eeeerrrrrrrroooorrrr____tttt
  31.      hhhhwwwwggggrrrraaaapppphhhh____vvvveeeerrrrtttteeeexxxx____uuuunnnnrrrreeeeffff((((vvvveeeerrrrtttteeeexxxx____hhhhddddllll____tttt _v_h_d_l))));;;;
  32.  
  33.    AAAArrrrgggguuuummmmeeeennnnttttssss
  34.      _v_h_d_l        Handle of existing vertex, input to the operation.
  35.  
  36.      _v_h_d_l_p       Address of a field to receive the handle of a new vertex
  37.                  created in the operation.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      These functions are used by the kernel to implement higher-level hwgraph
  41.      operations such as _h_w_g_r_a_p_h__c_h_a_r__d_e_v_i_c_e__a_d_d() (see _h_w_g_r_a_p_h._d_e_v(D3X)).
  42.      These functions are almost never needed by a device driver.  One reason
  43.      is that the higher-level functions properly manage the vertex reference
  44.      count, an issue with many complexities.
  45.  
  46.      +o   _h_w_g_r_a_p_h__v_e_r_t_e_x__c_r_e_a_t_e() creates a new vertex with a reference count
  47.          of 1.
  48.  
  49.      +o   _h_w_g_r_a_p_h__v_e_r_t_e_x__d_e_s_t_r_o_y() marks the vertex to be recycled when its
  50.          reference count falls to 0.
  51.  
  52.      +o   _h_w_g_r_a_p_h__v_e_r_t_e_x__c_l_o_n_e() makes a copy of a vertex.
  53.  
  54.      +o   _h_w_g_r_a_p_h__v_e_r_t_e_x__r_e_f() explicitly increments the reference count of a
  55.          vertex.
  56.  
  57.      +o   _h_w_g_r_a_p_h__v_e_r_t_e_x__u_n_r_e_f() explicitly decrements the reference count of a
  58.          vertex.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. hhhhwwwwggggrrrraaaapppphhhh....vvvveeeerrrrtttteeeexxxx((((DDDD3333XXXX))))                                        hhhhwwwwggggrrrraaaapppphhhh....vvvveeeerrrrtttteeeexxxx((((DDDD3333XXXX))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      Functions return GRAPH_SUCCESS when the operation completes successfully,
  76.      or a failure code as defined in _h_w_g_r_a_p_h._i_n_t_r_o(D3X) when the operation
  77.      does not complete successfully.
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      hwgraph.dev(D3X), hwgraph.intro(D4X).
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.